home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / comm2 / xraid123.lha / DOC / XConfig.doc next >
Text File  |  1995-08-23  |  32KB  |  765 lines
  1.  
  2.                                  XConfig 
  3.    Combined Documentation and Example Configuration for XTick and XRaid 
  4.        Copyright (c) 1995 by Robert Williamson, FIDONET#1:167/104.0
  5.                             ALL RIGHTS RESERVED
  6.  
  7.         This  software  is  provided  "as  is",  without warranty and/or
  8.     guarantee  of any kind.  You may use and/or distribute this software
  9.     and copies of it, as long as no alterations have been made, no files
  10.     have  been  added  to/omitted from the original distribution archive
  11.     and no charge is asked for.
  12.         This package may be freely distributed via BBSs, ADS, AmiNet and
  13.     software libraries such as Fred Fish's and Aminet CD-ROMs, and other
  14.     similar electronic channels.
  15.  
  16.         This  package  may  NOT  be  distributed SAN, Disk magazines, PD
  17.     libraries or BBSs and Services that charge  extra for file transfers
  18.     without authorization from, and compensation to the author.
  19.  
  20.                XConfig.DOC and the format of XTick.cfg are,
  21.        Copyright (c) 1995 by Robert Williamson, FIDONET#1:167/104.0
  22.  
  23.  
  24.     This  document may be used as the config file for both XTick and XRaid.
  25.   Simply  duplicate  it  as xtick.cfg and edit.  There is no need to remove
  26.   the  text,  as  it  is  ignored when read as a config file.  When you are
  27.   satisfied  that the configuration is correct, you can strip the text from
  28.   this  config  by  using  the  XRAID command STRIPCFG.  The config is also
  29.   stripped whenever XRaid updates it.
  30.  
  31.     Configuration  keywords  start  in  column  1, anything preceeded by at
  32.   least  1  space  is considered a comment.  There are no 'comment' symbols
  33.   required  in  this copyrighted config format. 
  34.   
  35.     The  Xconfig  format uses the readargs() function and standard AmigaDos
  36.   templates  for  all  configuration  items.  Note that only a few template
  37.   parameters  are  marked  as  '/A'  (REQUIRED),  since this also makes the
  38.   parameter  position-dependant.   This  allows  a  very freeform method of
  39.   usage and configuration.
  40.   
  41.     It  is  not  permitted  to  leave  the value of an un-commented keyword
  42.   blank.   For those keywords which are not required, they are UN-SPECIFIED
  43.   by commenting (inserting one or more spaces before it), or by setting the
  44.   value  to either "" or OFF as noted for the particular keyword.  Although
  45.   an  effort  is  made  to  catch  blank  keyword  value  errors, it is not
  46.   fool-proof.   Any  such  errors that go undetected can produce unexpected
  47.   results.
  48.  
  49.   
  50.   A quick explanation of AmigaDos Template Parameters used:
  51.  
  52.       none  - item is position dependant
  53.  
  54.       /C  - item is a comma-separated string
  55.             This is not a standard template
  56.  
  57.       /A  - item is required and must be in this position.
  58.  
  59.       /K  - item requires that both the KEYWORD and a value be specified.
  60.  
  61.       /N  - item is a number
  62.  
  63.       /S  - item is a boolean switch which is set TRUE when the keyword
  64.             is specified, and FALSE when it is not.
  65.  
  66.       /F  - a string may be specified, it MUST be the last item.
  67.  
  68.       /M  - multiple items may be specified
  69.  
  70.  
  71.     Configuration keywords are ordered as follows:
  72.  
  73.       Defaults and Globals
  74.         This includes your name and default address, files, paths, file
  75.         modes, tic modes and allowable xraid commands
  76.       Groups config
  77.         fileecho and FDN groups
  78.       Uplinks config
  79.         the systems that feed you, options, groups
  80.       Site/SiteAKA config
  81.         the systems that you feed, options, permissions, ticfile modes,
  82.         groups
  83.       Area config
  84.         area and FDN names and descriptions   
  85.         area paths
  86.         area execs overides
  87.         area sites and overides
  88.   
  89.   Addressing:
  90.     Addresses  can  be  specified  in  a  number  of formats in the Xconfig
  91.   format,   the  preferred  being  FQFA.   The  minimum  acceptable  is  3d
  92.   (z:net/node.)  for  FidoNet  and FTNS defined in FTNLIST.  All other FTNs
  93.   must be specified as 5D or FQFA.
  94.  
  95.         Address Formats:
  96.             FQFA  -   ftn#zone:net/node.point   (all must be present)
  97.             5d    -   zone:net/node[.point]@ftn (if no point, 0 is assumed)
  98.             4d    -   zone:net/node.point
  99.             3d    -   zone:net/node
  100.  
  101.   Paths:
  102.     A trailing slash is automatically added to paths when required.
  103.  
  104.   Quotes:
  105.     Configuration items do not need to be quoted.
  106.  
  107.   Command Parameter Expansion:
  108.     An  extensive  set  of  parameter  expansion/substitution variables are
  109.   provided.   The  current  design allows a maximum of 36.  The six command
  110.   keywords:   PACKER, IMPORTER, HATCHEXEC, TICKEXEC, and the AREA overrides
  111.   AHATCHEXEC  and ATICKEXEC, allow for both multiple commands (» parameter)
  112.   and  the expansion of parameters somewhat similar in concept to SilverBox
  113.   parameters   and   Ftick's   EXECUTE   keyword  with  some  very  special
  114.   enhancements.
  115.     Please see XTICK.doc for explanations.
  116.  
  117.     These  command  strings may contain the following templates.  Note that
  118.   the  words  or  substrings  in  UPPERCASE refer to the values of TIC file
  119.   keywords.
  120.     
  121.                Description                        Source of Value
  122.                of parameter                       Ticked    Hatched
  123.           »  : insert LF (ALT-0 on keyboard)      config    config
  124.  
  125.           %a : name of AREA                       tic file  config
  126.           %e : AREADESCription                    tic file  config
  127.           %n : FILEname                           tic file  cmdline
  128.           %g : original filename in FULLNAME      internal  internal
  129.           %m : FNC version of FULLNAME            internal  internal
  130.           %f : filename including path            internal  cmdline
  131.           %d : DESCription of FILE                tic file  filenote
  132.           %l : SIZE (length) of FILE              tic file  internal
  133.           %y : size of FILE as calculated         internal  internal
  134.           %c : CRC of FILE                        tic file  internal
  135.           %x : crc of FILE as calculated          internal  internal
  136.  
  137.           %b : bad directory                      config    config
  138.           %i : inbound directory                  config    config
  139.           %o : outbound directory                 config    config
  140.           %p : directory (path) of current area   tic file  config
  141.           %j : directory (path) for autoadd area  config    config
  142.           %t : name and path of recd tick file    cmdline   --
  143.           %u : name and path of created tick file internal  internal
  144.           %k : tic directory                      cmdline   config
  145.  
  146.           %r : FROM address (FQFA)                tic file  internal
  147.           %s : ORIGIN (source) address (FQFA)     tic file  internal  
  148.           %h : host address (FQFA)                internal  config
  149.  
  150.           %0  : host FTN (domain)                 internal  internal
  151.           %1  : host zone                         internal  internal
  152.           %2  : host net                          internal  internal
  153.           %3  : host node                         internal  internal
  154.           %4  : host point                        internal  internal
  155.  
  156.           %5  : from/to FTN (domain)              tic file  internal
  157.           %6  : from/to zone                      tic file  internal
  158.           %7  : from/to net                       tic file  internal
  159.           %8  : from/to node                      tic file  internal
  160.           %9  : from/to point                     tic file  internal
  161.         
  162.  
  163.  
  164.   Explanation of Config Keywords and Example Configuration:
  165.  
  166. SYSOP Robert Williamson
  167.       This is the name used by XRaid when sending messages via the SENDCMD,
  168.     GETHELP and GETSTATUS commands.
  169.  
  170. HOST FIDONET#1:167/104.0
  171.       The  default  address  for all filechos which do not have an OverRide
  172.     HOST  address specified.  This must be YOUR address.
  173.  
  174. POINTNET 30730/99
  175.       If  specified  in  the format FakeNet/Point, this will be used in
  176.     the  Path and Seenby of POSTTICK and POSTHATCH echomail messages.  If
  177.     specified  as  a  Point  number only, this will be used as the point in
  178.     MSGID address and in NetMail INTL and FMPT control lines.
  179.  
  180. UTC -360
  181.       The  offset  in  minutes  will be used to calculate the UTC from your
  182.     local  time.   This  value  is  added  to  your local time before XTick
  183.     inserts  any date-/time-strings into the path-lines of a Tick file.  In
  184.     addition those path lines will be marked with the "UTC" string.
  185.  
  186. FTNLIST "AMIGANET 39 AMIGANET 40 AMIGANET 41 IBMNET 40:6499 FishNet 77:77"
  187.       The  FTNLIST  is  a List of FTN NAMES and matching zones or zone:net.
  188.     This list should only consist of those FTN's in which you are connected
  189.     to FileEchos.
  190.       If  more  than one FTN uses the same Zone, add the net to one of them
  191.     in the list.  When a Zone is qualified by Net, the Zone and Net must be
  192.     separated  by  a  ':'(colon). Zone:Net combinations MUST be the last in
  193.     the list.
  194.       FidoNet  zones  1-6  need  not  be  included in the list as these are
  195.     handled  internally.   No  other FTN is permitted to use Zone numbers 1
  196.     though 6, but the Zone:Net combination will handle this..
  197.  
  198. QTYPE XFQ
  199.       Defines  the method of queueing outbound files.  Two methods are used
  200.     on the Amiga:
  201.       FLO - Flow File system (4d)
  202.       XFQ - xferq.library system (5d)
  203.  
  204.       If  QTYPE is set to FLO, 4 dimensional flow files and packets will be
  205.     created.   These  may  be either .FLO/.OUT or .HLO/.HUT, depending upon
  206.     the configuration of the site.
  207.  
  208.       If  QTYPE is set to XFQ, 5 dimensional packets of either type .OUT or
  209.     .HUT will be created.  (There are no flow files in xferq system).
  210.  
  211.       Please  not  that  some  mailers  may  be hybrid.  These mailers will
  212.       require 4d filenames but use xferq.library with a flo-file conversion
  213.       utility.  Such hybrid systems are not supported.
  214.  
  215. XPRI 50 -50
  216.       This keyword is used for QTYPE XFQ ONLY
  217.       Priority for Routed and Hold mail (range -127 to +127)
  218.       These  should  be the same values as used in your mailer.  You can set
  219.       Routed to the same value you use for Crash or Normal.
  220.  
  221.     Paths:
  222.  
  223. IN  Mail:Inbound/fidonet
  224.       Your inbound directory.  There is NO default value.
  225.  
  226. OUT Mail:outbound
  227.       Your outbound directory.  There is NO default value.
  228.  
  229. BAD BBSF5:BAD
  230.       The  directory  where  XTick  will  move all bad files. These include
  231.     Tic's  and  associated file for an unknown area, that did not match CRC
  232.     or  file  size  checks,  from  an unknown system, from a system without
  233.     hatch permission etc.
  234.      Tick  files  without  the  associated file are NOT moved.  There is NO
  235.     default value.
  236.  
  237. AUTOADDPATH BBSF5:
  238.       This  is  the  directory  where XTick will create new directories for
  239.     auto  added  fileechos.   The name of the directory created for the new
  240.     fileecho  area  is  based  on the fileecho tag.  If a directory already
  241.     exists  with  that  name, then XTick will use it, instead of creating a
  242.     new one.
  243.  
  244. TIC Mail:outbound/flo
  245.       The directory where XTick will create all TIC files for transmission.
  246.     This  can  be set to the same path as OUT.  However, if your mailer was
  247.     designed  with  security  in mind, it is preferable that this be set to
  248.     some other path.
  249.  
  250.  FLOWFLO <path>
  251.       This keyword is valid for QTYPE FLO ONLY.
  252.     Please note that it is commented out here by the preceeding space.
  253.       This  is  the directory where your flow file system mailer expects to
  254.     find  ?lo  files.  Mailers designed with security in mind allow setting
  255.     this to something other than OUTBOUND:.
  256.  
  257.  FLOWFNC <path>
  258.       This keyword is valid for QTYPE FLO ONLY.
  259.     Please note that it is commented out here by the preceeding space.
  260.       The  directory  where  files  with  filenames  converted to msdos 8.3
  261.     format  will  be  stored for transmission.  XTick places renamed copies
  262.     here  of  all  files  that require FNC (File Name Conversion) for sites
  263.     marked  as  needing  FNC.  Mailers designed with security in mind allow
  264.     setting this to something other than OUTBOUND:.
  265.       It is the operators responsiblity to clean-up.
  266.  
  267.  AUDIT MBACK:audit/
  268.     Please note that it is commented out here by the preceeding space.
  269.       GLOBAL Directory to backup created TICs and packets.  If set to "" or
  270.     not specified, they will not be saved. 
  271.  
  272.  BACKUP MBACK:INHOLD/
  273.     Please note that it is commented out here by the preceeding space.
  274.       GLOBAL Directory  to  backup  received  TICs  that  were successfully
  275.     processed.   If  set  to  ""  or not specified, processed tic's will be
  276.     deleted.
  277.  
  278. LOGFILE LOG:XTICK.LOG
  279.       Full PathName of the logfile. XTick and XRaid will use the same log.
  280.  
  281. LOGLEVEL 3
  282.       Loglevel control tha mount of info appearing in the log. The range is
  283.     0 to 9.
  284.  
  285. HELPFILE CFG:XRAID.HLP
  286.       Full path Name of the help file to be used by XRaid.
  287.  
  288. FILEBONE BBSF5:echolist/FILEBONE.NA
  289.       Global FileEcho List used by XRAID.
  290.       You  can  edit  this  file to add any information you wish.  You must
  291.       follow the format described.
  292.  
  293.     Display Configuration:
  294.  
  295. WSPEC           "KCON:0/10/640/100/"
  296.       GLOBAL device and size/position of XTick window,
  297.       must be terminated with a '/'
  298.  
  299. WFLAGS          "/INACTIVE/AUTO/"
  300.       GLOBAL Window flags for XTick window,
  301.       must begin and end with a '/'  
  302.  
  303. PSCREEN         "The Roof Multi-FTN Server"
  304.       GLOBAL public screen, set to "" if unused  
  305.  
  306.  
  307.     NewFile Annoucements:
  308.       A  newfiles message can be posted in one or more echos when a file is
  309.     hatched or ticked (received).
  310.       In  both *POST cases, if set to OFF, or if not specified, no messages
  311.     are  posted.  
  312.  
  313.       These can be overidden by the AREA post overides:
  314.          AHATCHPOST <command>
  315.          ATICKPOST <command>
  316.       
  317.       The  echomail  Messages are written as .PKTs in the GLOBAL default IN
  318.     directory  or  the  AREA's  IN  overide  and will be imported using the
  319.     defined IMPORTER command.
  320.  
  321. TICKPOST   NEWFILES      
  322.     TICKPOST  (TAGNAME...TAGNAME>
  323.       A list of space separated ECHO TagNames in which to post a message to
  324.     announce received files.
  325.       HatchPost is never executed when Forwarding (processing a Tic)
  326.  
  327.     HATCHPOST (TAGNAME...TAGNAME>
  328.       A  list  of  space seperated ECHO TagNames in which post a message to
  329.     announce hatched files.
  330.  
  331.  
  332.  
  333.     Command Configuration:
  334.  
  335. PACKER      run >nil: XPack
  336.       GLOBAL Command to route and pack outbound netmail
  337.       Accepts multiple commands and command parameter expansion.
  338.  
  339. IMPORTER    "run >nil: RX mail:rexx/InboundMGR TOSSPKT %0"
  340.       GLOBAL  command  to  import  echomail  created  by *POST commands and
  341.       netmail to yourself generated by Xtick or Xraid.
  342.       Accepts multiple commands and command parameter expansion.   
  343.  
  344.   Execute on Hatch or on Tick:
  345.       If  a  file  for  an  AREA is hatched or ticked (received), the given
  346.     command  is  executed  (unless the keyword is set to OFF for the AREA).
  347.     See  'EXEC  Commands  and AREA OverRides' section of XTICK.DOC for more
  348.     information.
  349.  
  350. HATCHEXEC  "Echo >>LOG:TICKLIST %n %s %l %a %d"
  351.       GLOBAL default command to execute when a file is HATCHED.
  352.       Accepts multiple commands and command parameter expansion.
  353.       Set to "" to disable. Can be overidden by Area.
  354.       HatchExec is never executed when Forwarding (processing a Tic)
  355.  
  356. TICKEXEC   "Run Rx Mail:rexx/TickMGR PROCESS %n %s %l %a %d" 
  357.       GLOBAL default command to execute when a file is TICKED.
  358.       Accepts multiple commands and command parameter expansion.
  359.       Set to "" to disable. Can be overidden by Area.
  360.  
  361.  
  362.     File Modes:
  363.       FILEMODES  defines how old tic files are handled when rehatching, how
  364.     files are handled when hatching from a different path than that defined
  365.     for  an  area,  when  processing a tic that has a REPLACES keyword, and
  366.     when duplicate filename is encountered.
  367.  
  368.     Template:
  369.     KILLTICS/S,TICKREPLACE/S,HATCHREPLACE/S,TICKOVERWRITE/S,HATCHOVERWRITE/S
  370.  
  371. FILEMODES KILLTICS HATCHOVERWRITE HATCHREPLACE
  372.  
  373.     TICKREPLACE     the REPLACES file named in the tic file will be deleted
  374.                     if it is found in the filearea PATH.
  375.                     If TICKREPLACE IS NOT specified, the REPLACES file is
  376.                     renamed to filename".OBS"
  377.                     TICKREPLACE can be OverRidden per area by an AREA
  378.                     NOREPLACE option.
  379.  
  380.     TICKOVERWRITE   any  file  of same name as FILE will be over-written by
  381.                     new one.
  382.                     If TICKOVERWRITE is NOT specified, any file with the
  383.                     same  name  as FILE is renamed to filename".OLD" before
  384.                     new one is moved to the filearea.
  385.  
  386.     HATCHREPLACE    if REPLACES name is specified, the file will be deleted.
  387.                     If HATCHREPLACE is NOT specified, the REPLACES file
  388.                     is renamed to filename".OBS".
  389.  
  390.     HATCHOVERWRITE  if a file is hatched from a path other than AREA path,
  391.                     FILE will be moved to area and any file of same name as
  392.                     FILE will be over-written.
  393.                     If  HATCHOVERWRITE  is NOT specifed, any file with the
  394.                     same  name  as FILE is renamed to filename".OLD" before
  395.                     the new file is moved to the filearea.
  396.         
  397.     KILLTICS        the TICDIR will be scanned for old tic files for the same
  398.                     AREA, SITE AND FILENAME.  If KILLTICS is specified, ALL
  399.                     tics will be read, and all matchs found will be deleted.
  400.                     If NOT specified, only the first old tic found is
  401.                     deleted.
  402.  
  403.   
  404.  
  405.     Tic Modes:
  406.       TICMODES defines the default format of the tic files created by XTICK.
  407.     This  default  format can be over-ridden by each SITE's config.  
  408.  
  409.     TICMODES Template:
  410.     STRIPSB/K,USEMLD/S,USEVIA/S,USETO/S,USEMAGIC/S,USEAD/S,USEFN/S,USETI/S
  411.  
  412. TICMODES  STRIPSB FTN USEMLD USEVIA USETO USEMAGIC USEAD USEFN USETI
  413.  
  414.     STRIPSB (ALL|FTN|ZONE|NET)
  415.             ALL   - All SEENBYS are stripped
  416.             FTN   - All SEENBYS from other FTNs are stripped
  417.             ZONE  - All SEENBYS from other ZONES are stripped
  418.             NET   - All SEENBYS from other NETs are stripped
  419.  
  420.     USEMLD        - LDESC lines are added to TIC
  421.     USEVIA        - CREATED lines are written to TIC as VIA lines, 
  422.                     "Created by' is stripped from CREATED line before
  423.                     conversion.
  424.               
  425.     USETO         - TO lines are added to TIC
  426.                     Some TICK handlers will choke on TO lines, notably
  427.                     FTick. 
  428.     USEMAGIC      - MAGIC lines are added to TIC
  429.     USEAD         - AREADESC lines are added to TIC
  430.     USEFN         - FULLNAME lines are added to TIC
  431.     USETI         - when hatching, XTick will search for a TicInclude
  432.                     file with the same names as the fileto hatch and
  433.                     the extension "TINC". The TINC file will be read
  434.                     and fields added to the TIC according to the
  435.                     TICMODES options and the Site's TICK options.
  436.  
  437.       In  all  cases,  the  lines  are  added  only  if  the information is
  438.     available.   ie a MAGIC line will not be added if the MAGIC name is not
  439.     defined.
  440.  
  441.  
  442.   Allowable XRaid commands:
  443.     ALLOWCMDS  defines  which sensitive functions and AreaMgr commands will
  444.   be accepted. See XRAID.DOC for more information.
  445.  
  446.   Template:
  447.   ALLOWFWD/S,AUTOADDUSERS/S,AUTOADDAREAS/S,ALLOWALL/S,ALLOWNOTIFY/S,
  448.   ALLOWPASSWORD/S,ALLOWECHOPASSWORD/S,ALLOWMESSAGE/S,ALLOWTICK/S,
  449.   ALLOWPAUSE/S,NORESUME/S,MINLEVEL/K/N
  450.  
  451. ALLOWCMDS ALLOWNOTIFY ALLOWMESSAGE ALLOWTICK NORESUME MINLEVEL 30
  452.  
  453.         AUTOADDAREAS    Should areas be created when files are received for
  454.                         an unknown area.
  455.  
  456.  
  457.         AUTOADDUSERS    Should unknown users be automatically added if an
  458.                         XRaid request is received. (NOT YET IMPLEMENTED)
  459.  
  460.         ALLOWFWD        Should a system be able to request fileechos not on
  461.                         site. If not specified, FWDREQ will be false for
  462.                         all sites.
  463.  
  464.         ALLOWALL        Should a system be able to use the %+ALL command to
  465.                         connect all available areas.
  466.  
  467.         ALLOWGROUP      Should a system be able to use the %+<GROUP> command to
  468.                         to connect to all areas i a group..
  469.  
  470.         ALLOWNOTIFY     Should a system be able to use the  %NOTIFY command
  471.                         to toggle the notify option.
  472.  
  473.         ALLOWPASSWORD   Should  a  system  be  able to  use  the  %PASSWORD
  474.                         command to change the areamgr (raid) password.
  475.  
  476.         ALLOWECHOPASSWORD
  477.                         Should  a system  be able to use  the %ECHOPASSWORD
  478.                         command to change the fileecho (ticfile) password.
  479.  
  480.         ALLOWMESSAGE    Should a system be able to use the %MESSAGE command
  481.                         to toggle the netmail announcement/file attach.
  482.  
  483.         ALLOWTICK       Should a system be able to use the %TICK command to
  484.                         toggle the Tic file options.
  485.  
  486.         ALLOWPAUSE      Should a  system be able to use the  %PAUSE command
  487.                         to  temporarily turn off all the areas.  If this is
  488.                         not specified  then  XRAID will  also  prevent  the
  489.                         system from using the %RESUME command.
  490.  
  491.         NORESUME        Disables the use of the %RESUME command even in 
  492.                         %PAUSE is allowed.
  493.  
  494.         COMPRESSION     Should a system  be able  to  use the  %COMPRESSION
  495.                         command to  change  the archiver  for  the  TicPack
  496.                         options. 
  497.                         Please note  %COMPRESSION is neither supported, nor
  498.                         included in template, but is documented in case we
  499.                         do add support in the future.
  500.  
  501.         MINLEVEL       The minimum raid level a user must have to use the
  502.                        allowed commands.
  503.  
  504.  
  505.     Group Configuration:
  506.       Each  GroupList  defines a set of FDNs as a GROUP.  These FDNs can be
  507.     those  defined as an AREA FDN (acroynom of a File Distribution Network)
  508.     such as LOCAL, or real FDN names as found in FILEBONE.NA.
  509.  
  510.       The FIRST GROUPLIST defined is GROUP 1 and is considered as the LOCAL
  511.     FDN.   GROUP  numbers are automatically assigned in a sequential manner
  512.     as the config is read.
  513.  
  514.       Each AREA must be assigned to one of these GROUPs.
  515.       Each UPLINK will have one of more of these GROUPs defined and will be
  516.     considered the FEED for the GROUP and the FDNS in that GROUP.
  517.       Each  SITE  will have a permission set to allow access to one or more
  518.     of the GROUPs. All SITEs have access to GROUP 1. 
  519.   
  520.     GROUPLIST Template:
  521.     GROUPLIST/K/A/F
  522.     
  523. GROUPLIST LOCAL,MTL
  524. GROUPLIST ADS,ANET
  525. GROUPLIST SDS
  526.  
  527.  
  528.   Uplink Configuration:
  529.       Uplinks  are the default systems to which XRAID will forward requests
  530.     for fileechos not presently on the system. 
  531.  
  532.   UPLINK Template:
  533.   UPLINK/K,MANAGER/A,PASSWORD/A,GROUPS/A
  534.  
  535. UPLINK FIDONET#1:167/100.0 ALLFIX PASSWD 1,3
  536. UPLINK FIDONET#1:167/207.0 ALLFIX PWDPWDP 2
  537. UPLINK AMIGANET#40:6/0.0 ALLFIX PASSAWORD 2 
  538.  
  539.     UPLINK      address of site
  540.     MANAGER     name of FIleEcho ARea Manager used
  541.     PASSWORD    our raid password with this site
  542.     GROUPS      Comma-separated lists of GROUPS that we have access to on
  543.                 this site. This list may be of FDNs or groups of FDNs as
  544.                 defined by GROUPNAME.
  545.                 
  546.  
  547.  UPLINK FIDONET#1:167/100.0 ALLFIX mypassword SDS,ADS,DFN
  548.  UPLINK AMIGA#40:600/0 ALLFIX mypwds ANET
  549.  
  550.     Site Configuration:
  551.       SIte configuration defines the addresses, options, passwords, levels,
  552.     and  permissions for a site.  Two forms of site configuration are used:
  553.     the  SITE  and  the SITEAKA templates.  The SITEAKA template is used to
  554.     define  additional  addresses  and  aka-specific  parameters  when site
  555.     having more than one address is connected to FDNs in more than one FTN.
  556.       The SITEAKA entry always applies to the previous SITE entry.
  557.  
  558.       SITE Template:
  559.       SITE/K,PW/K,RPW/K,RLVL/K,FWDREQ/S,AUTOADD/S,GROUPS/K,
  560.         HOLD/S,ATTACH/S,FNC/S,NOTIC/S,TIC3D/S,NOREPORT/S,
  561.         NOTO/S,NOMD/S,NOMA/S,NOAD/S,NOFN/S,NOTI/S
  562.  
  563.       SITEAKA Template:
  564.       SITEAKA/K,PW/K,RPW/K,RLVL/K,FWDREQ/S,AUTOADD/S,GROUPS/K,
  565.         HOLD/S,ATTACH/S,FNC/S,NOTIC/S,TIC3D/S,NOREPORT/S,
  566.         NOTO/S,NOMD/S,NOMA/S,NOAD/S,NOFN/S,NOTI/S
  567.  
  568.       SITE      - primary address of site, cannot be specified in the same
  569.                   line as SITEAKA
  570.       SITEAKA   - aka of SITE, cannot be specified in the same line as SITE
  571.                   accepts all options, over-riding those set for the SITE
  572.                   or a SITEAKA defined previously. 
  573.       PW        - TIC file password, minimum 6 characters, case insensitive
  574.       RPW       - RAID password, minimum 6 characters, case insensitive
  575.       RLVL      - RAID Access Level
  576.       FWDREQ    - site can request filechos we don't have and the request
  577.                   will be forwarded to uplink
  578.       AUTOADD   - new areas from this site will be automatically added
  579.       GROUPS    - Groups to which site has access 
  580.  
  581.       TIC3D     - addresses in TIC file are 3d instead of FQFA for
  582.                   sites running poorly written File Forwarders
  583.       NOREPORT  - do not send report to site
  584.       FNC       - send filenames in 8.3 format 
  585.  
  586.     The following three can be overidden by an AREA's ECHOTO config 
  587.       HOLD      - Put stuff on hold for site 
  588.       NOTIC     - do not send TIC file to site
  589.       ATTACH    - send file attach message to site
  590.  
  591.       Disable of TicFile extensions:
  592.       NOTO      - TO keyword is not added to TIC file for this site
  593.       NOMA      - MAGIC keyword is not added to TIC file for this site
  594.       NOAD      - AREADESC keyword is not added to TIC file for this site
  595.       NOFN      - FULLNAME keyword is not added to TIC file for this site
  596.       NOTI      - TICINCLUDE data (execpt for an included DESC),
  597.                   is not added to TIC file for this site
  598.   
  599.     
  600. SITE FIDONET#1:167/192.0 PW ROOFRX RPW erwrwewer RLVL 50 GROUPS 1,2,3
  601. SITEAKA AMIGANET#40:600/12.0 RLVL 20 GROUPS 2
  602. SITE FIDONET#1:167/151.0 PW xcxcxcxc RPW bvbvbvbv RLVL 50 NOTO
  603. SITEAKA AMIGANET#40:600/0.0 RLVL 75 HOLD
  604. SITEAKA AMIGANET#40:6/1.0
  605. SITE FIDONET#1:167/107.0 PW sdsdsd RPW Tasdasd RLVL 50 GROUPS 1,2,3
  606. SITE FIDONET#1:167/104.99 PW werwer RPW dfgfdg RLVL 50 FNC NOTO NOAD GROUPS 1,2,3
  607. SITE FIDONET#1:167/104.98 PW werwere RPW hjkhjkhjk RLVL 50 FNC TIC3D  GROUPS 1,2,3
  608. SITE FIDONET#1:167/104.97 PW rtyrtyy RPW dfgdfgg RLVL 50 TIC3D GROUPS 1,2,3
  609. SITE FIDONET#1:167/100.0 PW dfgdfgdf RPW dfgdfg RLVL 50 FNC GROUPS 1,3
  610.  
  611.  
  612.  
  613.     FileEcho Configuration:
  614.       Areas   configuration  uses  the  AREA,  ECHOTO,  ADESC,  CROSSHATCH,
  615.     ATICKPOST,  AHATCHPOST,  ATICKEXEC, AHATCHEXEC keywords.  The first two
  616.     are REQUIRED.
  617.  
  618.       AREA
  619.         Defines the tagname and path of the filearea, with optional area
  620.       host address, area password, area description and REPLACES disable.
  621.  
  622.  
  623.       AREA Template:
  624.         AREA/K,APATH/K,APW/K,ARLVL/K,FDN/K,GROUP/K/N,IN/K,OUT/K,ANOHATCH/S,ANOREPLACE/S,HOST/K
  625.         AREA        - TAGNAME of FileEcho (required)
  626.         APATH       - Path of fileecho    (required)
  627.         FDN         - acrynom of File Distribution Network
  628.         GROUP       - group number for this fileecho
  629.         IN          - Inbound post message directory for AREA
  630.         OUT         - Outbound notify/report message directory for AREA
  631.         APWD        - Password of AREA
  632.         ARLVL       - User RAID Level needed to request AREA
  633.         HOST        - our address for this FileEcho
  634.         ANOHATCH    - hatching is not permitted in this AREA
  635.         ANOREPLACE  - disallow Replaces filename
  636.  
  637.       ADESC
  638.         Provides  a  Description of the AREA.  This is used in reports and in
  639.       the AREADESC field of the TIC file.
  640.  
  641.       ADESC Template:
  642.         ADESC/K
  643.  
  644.       FDND
  645.         Provides a description for the FDN for this fileecho. 
  646.  
  647.       FDND Template:
  648.         FDND/K
  649.  
  650.  
  651.       CROSSHATCH
  652.         Defines the tagname and file specs for cross hatching.
  653.  
  654.       CROSSHATCH Template:
  655.         CROSSHATCH/K,CROSSSPECS/A
  656.         CROSSHATCH  - TAGNAME of AREA to hatch any file matching
  657.                       patterns in CROSSSPECS
  658.         CROSSSPECS  - AmigaDos file specifications
  659.                       multiple specs, as well as pattern matching,is permitted
  660.                       eg:
  661.                       CROSSHATCH POINTDIFFS SMALLNL.#?
  662.  
  663.  
  664.       ECHOTO
  665.         Defines  the  sites  connected to the filearea and the permisssions
  666.       and overrides for each site.
  667.  
  668.       ECHOTO Template:
  669.       TOSITE/A,ISFEED/S,CANHATCH/S,HOLD/S,NOTIC/S,NOSEND/S,ATTACH/S
  670.         TOSITE    - address of site connected to FileEcho
  671.  
  672.         ISFEED    - TOSITE is the FEED for this echo
  673.                     Do not send files if recd from TOSITE
  674.         NOSEND    - TOSITE is the FEED for this echo
  675.                     NEVER send files to TOSITE  
  676.         CANHATCH  - TOSITE can hatch files in this echo
  677.  
  678.         The following three will overide the settings in the SITE defaults,
  679.       for  this  AREA  only.   If NOT SPECIFIED, the GLOBAL default will be
  680.       used, if any.
  681.  
  682.         HOLD      - Put files on Hold for TOSITE
  683.         NOTIC     - do not send TIC file to TOSITE
  684.         ATTACH    - send file attach message to TOSITE
  685.  
  686.  
  687.       ATICKPOST
  688.         Defines the echos in which to post TICK annoucements for this AREA.
  689.       If  specified,  these  echos  are used instead of the GLOBAL TICKPOST
  690.       echos.  If set to OFF, the function is DISABLED for the AREA.  If NOT
  691.       SPECIFIED, the GLOBAL definition will be used, if any.
  692.  
  693.       ATICKPOST Template:
  694.       ATICKPOST/K/F
  695.  
  696.       AHATCHPOST
  697.         Defines  the  echos  in  which  to post HATCH annoucements for this
  698.       AREA.   If  specified,  these  echos  are  used instead of the GLOBAL
  699.       HATCHPOST  echos.   If  set  to OFF, the function is DISABLED for the
  700.       AREA.  If NOT SPECIFIED, the GLOBAL definition will be used, if any.
  701.         
  702.       ATICKPOST Template:
  703.       ATICKPOST/K/F
  704.  
  705.  
  706.       ATICKEXEC, AHATCHEXEC
  707.         These  are the commands to execute when a tick or hatch has occured
  708.       in  the  AREA.  These keywords accept multiple commands and parameter
  709.       expansion.  If set to OFF, the function is DISABLED for the AREA.  If
  710.       NOT SPECIFIED, the GLOBAL definition will be used, if any.  See 'EXEC
  711.       Commands and AREA OverRides' section for more information.
  712.  
  713.       Templates:
  714.       ATICKEXEC/K/F
  715.       AHATCHEXEC/K/F
  716.  
  717.  
  718.       FILETICKEXEC,FILEHATCHEXEC  (not yet implemented)
  719.         These  commands  will  be  executed  if  the ticked or hatched file
  720.       matches the defined file specification.
  721.  
  722.       Templates:
  723.       FILEHATCHEXEC/A,CMD/F
  724.       FILETICKEXEC,CMD/F
  725.         eg:
  726.       FILETICKEXEC ????DIFF.A?? run >nil: DIFFMGR %f
  727.       FILETICKEXEC #?.ADS Delete %f
  728.  
  729. AREA ROOF APATH BBSF6:roof/ FDN LOCAL GROUP 1 APW ROOFRX ARLVL 0
  730. ADESC Roof Utilitites
  731. FDND Local FileEchos
  732. CROSSHATCH TEST XTICK.#? XRAID.#?
  733. AHATCHPOST ROOF_PROJECT
  734. ECHOTO FIDONET#1:167/100.0 CANHATCH NOSEND
  735. ECHOTO FIDONET#1:167/151.0 CANHATCH ATTACH 
  736. ECHOTO AMIGANET#40:600/12.0 ATTACH
  737.  
  738. AREA SHELTER APATH BBSF6:WPL/ FDN LOCAL GROUP 1 ARLVL 0 
  739. ADESC Shelter and Melody Mailers
  740. FDND Local FileEchos
  741. AHATCHPOST ROOF_PROJECT FALCON_CBCS
  742. ECHOTO FIDONET#1:167/151.0 CANHATCH ATTACH
  743. ECHOTO AMIGANET#40:600/12.0 ATTACH
  744.  
  745. AREA ADSFIDO APATH BBSF5:ADSFIDO/ FDN ADS GROUP 2 ARLVL 50 
  746. ADESC Amiga FidoNet Software
  747. FDND Amiga Distribution System
  748. ECHOTO FIDONET#1:167/151.0 CANHATCH ATTACH
  749. ECHOTO FiDONET#1:167/192.0 CANHATCH ATTACH
  750.  
  751. AREA ECHOLIST ANOHATCH FDN SDS GROUP 3 APATH BBSF5:ECHOLIST/ ARLVL 60
  752. ADESC EchoList and Policies
  753. FDND Software Distribution Service
  754. AHATCHEXEC OFF
  755. ECHOTO FIDONET#1:167/100.0 ISFEED NOSEND
  756. ECHOTO FIDONET#1:167/151.0 
  757.  
  758. AREA TEST APATH RDEV:xT/TEST/ FDN LOCAL GROUP 1 ARLVL 10 
  759. ADESC Test File echo
  760. FDND Local FileEchos
  761. ECHOTO FIDONET#1:167/104.97 
  762. ECHOTO FIDONET#1:167/104.98
  763. ECHOTO FIDONET#1:167/104.99
  764.  
  765.